home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / bbsfind1.zip / BBSFIND.DOC next >
Text File  |  1992-04-26  |  4KB  |  134 lines
  1.                         Welcome to BBSFIND!
  2.  
  3.  
  4.  
  5. REGISTRATION
  6. ------------
  7. This version of the program is released as FreeWare. It is free and is
  8. dedicated to the public domain for private, non-commercial users.
  9.  
  10. **Commercial and Government are requested to register and support its
  11. continued development.  To register, please send your name, address
  12. and phone number(s) with the registration fee of US $10.00 to:
  13.  
  14. Dave Wilga
  15. 304 Hickory ln.
  16. Seffner, FL 33584
  17.  
  18. (Outside US, please add $5.00**).
  19.  
  20.  
  21.  
  22. DISTRIBUTION
  23. ------------
  24. You may make copies of the program files for and the documentation file
  25. BBSFIND.DOC (this file) together and distribute them to others and upload
  26. them to bulletin boards for non-commercial purposes. The program files 
  27. should not be distributed without the documentation file BBSFIND.DOC.
  28. None of the files should be modified in any way.  
  29.  
  30.  
  31.    *******************************  NOTICE  ********************************
  32.    *    This program, and all supporting programs and documentation are    *
  33.    *    provided "as is" without warranty of any kind, either expressed    *
  34.    *    or implied, including but not limited to the implied warranties    *
  35.    *    of merchantability and fitness for a particular purpose.  In no    *
  36.    *    event will I, Dave Wilga be liable to you for any damages          *
  37.    *    arising out of the use or inability to use this program and/or     *
  38.    *    all supporting programs and documentation.                         *
  39.    *************************************************************************
  40.  
  41.    End of legal B.S.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                    1
  61.                             BBSFIND.DOC
  62.  
  63.  
  64. This program was conceived of and designed by me in order to process a
  65. shortcoming within PCBoard upload file checking routines.  Although PC-Board
  66. v14.5a has some EXCELLENT new features they were a little lax in not allowing
  67. a SysOp the option of checking an upload against existing files with another
  68. extension.
  69.  
  70.  
  71.  
  72. For example:
  73. ===========================================================================
  74.  
  75. Your BBS is set up in a ZIP format and someone wants to upload an ARJ file
  76. to your BBS.
  77.  
  78. No problem you say?
  79.  
  80. Well, what if that file is already on your BBS in the ZIP format??
  81. PCBoard will fail to check this and blindly allow the upload giving you
  82. needless duplication of files!  Not to mention your workload as a Sysop
  83. goes up trying to find these duplicates.
  84.  
  85.  
  86.  
  87. Well folks, here is the answer!  BBSFIND!
  88.  
  89. Using the Turbo-C command fnsplit, it will break down the uploaded filename
  90. into it's respective parts and pull out JUST the filename (no extention).
  91. Then, it makes a call to the external file finder:  WHEREIS.EXE
  92.  
  93. Whereis receives the following parameters :
  94.  
  95. Whereis  FILENAME  -x*.exe -x*.com -x*.bat -x*.btm
  96.  
  97. This will bypass all executable and batch file you may currently be using
  98. and restrict the comparison to archived files only.
  99.  
  100.  
  101.  
  102. epilogue:
  103. =========
  104. Now some of you may say that WIZ20 or FIND219 or some other file finder is
  105. a lot faster.  Well, I won't nitpick about a few microseconds here or there
  106. but Whereis is the ONLY item I could find ANYWHERE in the shareware arena
  107. which would return a different DOS ERRORLEVEL based on a Find/NoFind situation.
  108. If you have another file finder you prefer to use that will return a consistant
  109. DOS errorlevel for a find/nofind let me know and I'll codify you a special
  110. version for a price (even for a beer or two  <grin> ).
  111.  
  112. I am currently working on writing a version of BBSFIND which uses an INTERNAL
  113. file finder program but it won't be as fast as I only know C and BASIC and as
  114. far as file finders are concerned, Assembly Language is the ONLY way to go.
  115.  
  116.  
  117. I have included a copy of the latest Whereis (v4.4) as well as a sample
  118. PCBTest.bat file for a PCBoard system.   Also included is WHATEXT.ZIP
  119. which finds just about any DOS file extention used in file archives. It is not
  120. needed for BBSFind to work but is required for the example PCBTEST.BAT given.
  121.  
  122.  
  123.  
  124.  
  125.  
  126. Simple??  Yes!                                           
  127. Useful??  You tell me.....
  128.  
  129. Dave Wilga , Sysop
  130. Terminal Velocity BBS
  131. Clearwater, Fl
  132. 813-535-3349
  133.  
  134.